Adding a data reference to a form

Add a data reference to a form to prompt users with a list of data records. By using data references, you integrate data with cases in your application.

For example, you can reference the Vehicle data type on an accident claim form to display a list of car models.

To add a data reference:

1. In the Explorer panel, click Cases, and then click the case type that you want to open.

2. On the Life cycle tab, click an assignment or approval step.

3. Click Configure view.

4. Click + Add field.

   In the autocomplete field that is displayed, enter a unique label.

   Do not use px, py, or pz prefixes in a label because they are reserved.

5. From the first list, select Data reference.

6. From the second list, select a display mode that is supported by your field type.

   Display modes include:

   • Optional — Users do not need to enter a value in the field to submit the form.

     This is the default display mode.

   • Required — Users must enter a value in the field to submit the form.

   • Read-only — Users can view the value in the field but cannot edit it.

   • Calculated (read-only) — Users do not enter values in the field.

     The value of the field is determined by a declare expression at run time.

7. From the third list, select the name of a data type.

8. Click the Gear icon and specify how a user can select records for this field.

9. Optional: Add read-only fields to the form that are displayed when a user selects a data record.

   To add read-only fields:

   1. Click + Add field to [data type].

   2. Select a property from the list.

      This list is populated with properties that are defined in the data type.

   3. Repeat steps 1 through 2 to add more read-only fields.

10. Optional: Drag a field to change its position on the form.

11. Click Submit.

After you add a data reference to a form, you can reuse the field because it is part of the data model for your case type. At run time, the data reference is displayed as an autocomplete field that is populated with a list of data records. Users can search for a data record by entering text in the field.

Open topic with navigation